home *** CD-ROM | disk | FTP | other *** search
/ Nightshift Sound & Vision / Nightshift - Sound & Vision.iso / programs / sound / hipplayer / hippoplayer.doc < prev    next >
Text File  |  1995-05-19  |  47KB  |  1,347 lines
  1. ******************************************************************************
  2.  
  3.                             *** HippoPlayer *** 
  4.  
  5.                   Programmed by K-P Koljonen 
  6.                  ** Hippopotamus Design ** 
  7.  
  8.             Copyright ⌐ 1994-1995 K-P Koljonen
  9.                              ** SHAREWARE **
  10.  
  11. ******************************************************************************
  12.  
  13.  
  14. HippoPlayer (HiP) is a multiformat module player for the Amiga.  It works
  15. perfectly under Kickstart 1.2 and has all the same and even more features
  16. than the players requiring Kick2.0+ to run.
  17.  
  18. One main reason why I started making this program was that there were no
  19. good Kick1.3 compatible players around, or I didn't know of one.  The other
  20. reason was that my good friend Jarno Paananen (Guru/Sahara Surfers) made a
  21. replay routine for Screamtracker ]I[ modules.
  22.  
  23. The aim was to make a good module player that works on every Amiga
  24. configuration and has lot's of USEFUL features.  To achieve speed, little
  25. size and memory usage, HiP is 100% assembler.
  26.  
  27. "Newcomers will run screaming away", said Nemesis1.
  28. At first HiP may seem complicated.  There's no familiar tapedeck symbols,
  29. only some bits of text scattered around.  Learn to use HiP, it should be
  30. worth the effort :)...
  31.  
  32. HiP has good support for Screamtracker ]I[, Fasttracker 1 & 2, Taketracker,
  33. and Multitracker modules (from here onwards referred as PS3Ms), meaning
  34. that you can listen them with a 68000 Amiga with listenable quality.  All
  35. are played by the famous replayer by Guru.  HiP was the second program to
  36. use the PS3M-routines after Guru's own player.
  37.  
  38.  
  39.  Some features:
  40.  ╖ Screamtracker ]I[, Fasttracker 1 & 2, Taketracker, Multitracker, 1 to 32ch
  41.  ╖ SID-emulation by Hσkan Sundell & Ron Birk (works even on kick1.2)
  42.  ╖ TFMX-modules, normal and the seven channel ones
  43.  ╖ A bunch of 4-8 channel sample & synth music formats
  44.  ╖ Easy to use, nice 3D-interface
  45.  ╖ Keyboard control
  46.  ╖ AppWindow
  47.  ╖ ARexx 
  48.  ╖ Public screen support
  49.  ╖ Internal multitasking
  50.  ╖ Loads and decompresses XPK, FImp, PowerPacker, LhA, LZX and Zip files
  51.  ╖ Tested on:
  52.      A500/000, kickstart 1.2, 0.5+0.5m memory
  53.      A1200/030, kickstart 3.0/1.3, 2+4m memory (with enforcer)
  54.  
  55. HippoPlayer was/is developed on:
  56.     - v1.00-v1.25    A500/010, kickstart 1.3/3.1, 1+2M memory, HD
  57.     - v1.27-v1.40    A1200/020, kickstart 3.0, 2+0M memory, HD
  58.     - v2.00-v?.??    A1200/030, kickstart 3.0, 2+4M memory, HD
  59.  
  60.  
  61. ******************************************************************************
  62. *                            *** Registration ***                     *
  63. ******************************************************************************
  64.  
  65. HippoPlayer is shareware and copyright ⌐ 1994-95 K-P Koljonen. 
  66.  
  67. If you like using HiP and would like to encourage me to continue developing
  68. and help me as well (as I'm a poor student :), you should consider
  69. registering.
  70.  
  71. To register, send a disk and some money (30-40 FIM or 7-9 USD or about
  72. equivalent amount of notes of other currencies or eurocheques) to my
  73. address found at the bottom of this doc.  Remember to mention your address!
  74. You will get the disk back with the latest version of HiP and a keyfile,
  75. which you MUST NOT SPREAD.  It is for your own use only.  This keyfile will
  76. work with possible future versions too.
  77.  
  78. Registering by e-mail is also possible.  Send the money by normal mail and
  79. I will mail you the keyfile.
  80.  
  81. There's no difference between registered and unregistered version!
  82.  
  83. Support quality software, register.
  84.  
  85.  
  86. Distribution
  87. ------------
  88. HippoPlayer can be freely distributed as long as all files are included
  89. unaltered.  Not for commercial use without a permission from the author.
  90.  
  91.  
  92.  
  93. ******************************************************************************
  94. *                           *** Requirements ***                     *
  95. ******************************************************************************
  96.  
  97. Any Amiga with some memory and Kickstart 1.2 or higher.  Reqtools.library
  98. of any version will be needed for the requesters.  There is kick1.3
  99. reqtools.library included in the archive.
  100.  
  101. In order to...             you need...
  102. ------------------------------------------------------------------
  103. Load XPK files            xpkmaster.library and some sublibs
  104. Load PowerPacker files        powerpacker.library
  105. Load lha, lzx and zip files    to look at 'Archivers'
  106. Play SID files            PlaySID.library
  107. Play 4ch MED modules        medplayer.library v2+
  108. Play 5-8ch MED modules        octaplayer.library v2+
  109.  
  110. All libraries must be copied into Libs: drawer.
  111.  
  112. reqtools.library and powerpacker.library by Nico Franτois.
  113. xpkmaster.library by Urban Dominik Mⁿller (?).
  114. PlaySID.library by Per Hσkan Sundell & Ron Birk.
  115. medplayer.library and octaplayer.library by Teijo Kinnunen.
  116.  
  117.  
  118. Installation
  119. ------------
  120. Copy HiP and the info-file wherever you keep your tools.  There are two
  121. 4-color and two MagicWB icons to choose from.  Also copy reqtools.library
  122. in libs:  if it's not there already.
  123.  
  124. Copy HippoPlayer.Group into S:  or define the location in Prefs/Player
  125. group later.
  126.  
  127. The use of HiP-script is described in 'Archivers'.
  128.  
  129.  
  130.  
  131.  
  132.  
  133. ******************************************************************************
  134. *                           *** Music formats ***                     *
  135. ******************************************************************************
  136.  
  137. Here's a list of the music formats HippoPlayer can play and what functions
  138. they support.  Also the authors of the replayers are listed.
  139.  
  140. Stop/Continue     = 1 - The music can be stopped and continued.
  141. Multiple songs    = 2 - Modules can have more than one song.
  142. Volume          = 3 - Volume can be controlled.
  143. End detect      = 4 - Songend can be detected.
  144. Forward/backward  = 5 - You can jump forwards and backwards in the song.
  145.  
  146. Replayer            12345    Author
  147. --------------------------------------------------------------------
  148. [** Built-in replayers **]
  149.  
  150. David Whittaker            xx---*    David Whittaker
  151. Delta Music v2.0        x-x--*    Bent Nielsen
  152. Fred                xx---*    Frederic Hahn & JC
  153. Maniacs of Noise        xxx--*    Maniacs of Noise
  154. Mark II                x----*    Cachet Software
  155. MED 4-8ch (player libraries)    xx-xx    Teijo Kinnunen
  156. Music Assembler            x-x--*    Oscar Giesen & Marco Swagerman
  157. Protracker            xxxxx    K-P Koljonen
  158. PS3M                x-xxx    Jarno Paananen
  159. SID (player library)        xx--x    Hσkan Sundell & Ron Birk
  160. SIDMon v1.0            x----*    Reiner van Vliet
  161. Sonic Arranger            -x---*    Carsten Schlote
  162.  
  163. [** Replayers in player group file **]
  164.  
  165. BP SoundMon v2.0        x-xxx    Brian Postma
  166. BP SoundMon v3.0 (v2.2?)    x-xxx    Brian Postma
  167. Future Composer v1.0-v1.4    x-xx-    SuperSero (of the Superions)
  168. JamCracker            x--x-    M. Gemmel
  169. Oktalyzer            --xx-    Armin Sander
  170. TFMX                xxxxx    Chris Hⁿlsbeck
  171. TFMX 7ch            xxxxx    Chris Hⁿlsbeck & Jochen Hippel
  172. The Player 6.1A            x-x--    Jarno Paananen
  173.  
  174.  
  175. The modules of formats marked with '*' have the replay code inside the
  176. module itself.  I can't guarantee will they work or not.  This is also the
  177. reason why they are not in the player group file (no replay code).
  178.  
  179. Most of the formats included are here just because I have some modules of
  180. them and I like to play them with HiP.  :)
  181.  
  182.  
  183. Player group (See Prefs)
  184. ------------
  185. Player group (HippoPlayer.Group) is a file consisting of above mentioned
  186. replayers.  The reason for this is that by moving seldom used replayers
  187. into a separate file memory usage is reduced by 25kB.  Not that much, you
  188. think.  But maybe just enough to prevent some actions from happening on low
  189. memory systems/situations.
  190.  
  191.  
  192.  
  193. Loading files
  194. -------------
  195. Normally all modules will be loaded in CHIP.  SID-, Oktalyzer- and PS3M-
  196. modules and TFMX song data will be loaded in FAST RAM if possible.
  197.  
  198. All compressed files will be loaded in CHIP.  However, it's possible to
  199. uncompress some kilobytes from the beginning of an XPKed file, and check if
  200. it is one of the above or a PT module that is to be played with PS3M or
  201. with fastram replayer.
  202.  
  203. Advantages of loading to FAST:
  204.     FAST RAM is much faster than CHIP, so mixing can be done faster.
  205.     CHIP RAM is saved if the module can or should be loaded in FAST.
  206.  
  207. LhA, LZX and Zip files can be checked and will be loaded in FAST if
  208. necessary.
  209.  
  210.  
  211.  
  212.  
  213. Protracker
  214. -----------
  215. The most popular music format on the Amiga.  HiP features my own Protracker
  216. play routine.
  217.  
  218. - Multisong modules
  219. There are some modules around with several songs separated by the B
  220. command.  HiP allows you to play these kind of modules correctly.  Just use
  221. the 'PS' and 'NS' gadgets (or the respective keys) to select different
  222. songs.  The only player that supports this feature, by the way :).
  223.  
  224. - Fast ram player
  225. This player can play PT modules from FAST RAM using only 1024 bytes of CHIP
  226. RAM.  Useful for very big modules.  CPU usage on my A1200/030/28Mhz is
  227. about 2-3%, and on my little brother's A500/000 about 15%.
  228.  
  229.  
  230.  
  231.  
  232. TFMX
  233. ----
  234. HiP can play both 4 and 7-channel TFMX modules, including the excellent
  235. Turrican 2 and 3 intro tunes.  A TFMX module consists of two files.  They
  236. must be named 'mdat.<name>' and 'smpl.<name>'.  To play, select
  237. 'mdat.<name>'.  HippoPlayer will then try to load the 'smpl.<name>' file.
  238.  
  239. The mixing rate of TFMX 7 channel replayer can be changed.  The bigger
  240. value, the better quality and bigger CPU load.  If you lose some notes or
  241. hear 'crackling' in the sound try lowering the mixing rate.
  242.  
  243.  
  244.  
  245. PS3M 
  246. ----
  247. (Screamtracker ]I[, Protracker, Fasttracker 1 & 2, Taketracker, Multitracker)
  248.  
  249. Jarno Paananen (Guru/Sahara Surfers) has made replayers for these.  It is
  250. able to play 1-32 voices simultaneously by mixing them through four
  251. channels.  The mixing routine is amazingly fast, even on Amiga 500 8
  252. channel modules are very listenable.  The replayer gobbles quite a bit of
  253. memory for it's buffers, so don't be surprised.
  254.  
  255. Mixing rates can be changed.  Again, the bigger value, the better quality
  256. and bigger CPU load.  Using the system friendly mode on A500 will probably
  257. more or less jam the machine, therefore you should use the killer mode for
  258. the best quality. 
  259.  
  260. PS3M allows mixing rates higher than 28kHz, which is normally the hardware
  261. limit.  In some AGA screen modes (dblPAL, dblNTSC, atleast) mixingrates can
  262. be upto 56kHz high.  Ofcoz, this doesn't work under OCS/ECS Amigas.
  263.  
  264. Killer mode WILL cause enforcer hits!  It bangs some of the interrupt
  265. vectors.  Don't use enforcer with killer mode.
  266.  
  267. These modules can and should be played from FAST RAM.
  268.  
  269. Play mode
  270. - - - - -
  271. Mono        Play all channels on both sides.
  272. Stereo        Normal.
  273. Surround    Play some of the right side on the left and vice versa.
  274. Real Surround    About the same, but uses more memory.
  275. 14-bit stereo    BEST QUALITY, biggest CPU load, largest memory usage and
  276.         lowest volume level.
  277.  
  278.  
  279.  
  280. SID
  281. ---
  282. These are tunes ripped from C64 games & demos.  Both normal file + icon and
  283. one file formats are supported.  The playing is done by PlaySID.library by
  284. Hσkan Sundell and Ron Birk.  Great job dudes!
  285.  
  286. *** Note!  Under Kickstart 1.2/1.3 playsid.library v1.1 does not work
  287. because it uses some Kick2.0+ functions.  I have made a little patch to
  288. bypass the problem.  This patch works ONLY with lib version v1.1 and
  289. Kick1.2/1.3.
  290.  
  291.  
  292.  
  293. ******************************************************************************
  294. *                     *** Gadgets & keyboard controls ***                    *
  295. ******************************************************************************
  296.  
  297. Keyboard shortcuts are bracketed.  The keys work from both main window and
  298. prefs window.
  299.  
  300.  New    Clear the module list, select new modules and play the first one.
  301.  
  302.  Play    Load and/or play selected module. If nothing selected, pop up
  303.     file requester. [RETURN/ENTER]
  304.  
  305.  Cont    Continue playing after stop.
  306.  
  307.  Stop    Stop playing.
  308.  
  309.  Eject    Stop playing and free current module. [TAB]
  310.  
  311.  Prev    Load and play previous module. [K]
  312.  
  313.  Next    Load and play next module. [L]
  314.  
  315.  PS    Play previous song. [ARROW LEFT]
  316.  
  317.  NS    Play next song. [ARROW RIGHT]
  318.  
  319.  <    Backward, jump to previous pattern. [,]
  320.  
  321.  >    Forward, jump to next pattern. [.]
  322.  
  323.  Add    Add modules to the end of the list, pop up the file requester. [A]
  324.     When adding files to the list you can also add directories.
  325.     With Kick2.0+ HiP will perform a recursive directory scan adding all
  326.     files in dir to the list. With Kick1.2/1.3 only one sub dir is added.
  327.  
  328.  Del    Delete selected module from the list. [BACKSPACE]
  329.  
  330.  Clr    Clear the list. [D]
  331.  
  332.  Horizontal slider
  333.     Volume controller. [B][N]
  334.  
  335.  ?    Enter the info window. [HELP]
  336.       Samplenames  Displays sample names of MODs, S3Ms, XMs, FTMs and
  337.                MTMs.
  338.       SID-info     Information about SID-modules.
  339.  
  340.                Sample names or SID-info can also be invoked by
  341.                pressing left mousebutton on the leftmost third
  342.                        of the name/type box or the 'I' key. (When there's
  343.                        no info available the info window will be opened.)
  344.  
  345.       Help           Description of gadgets & keyboard shortcuts.
  346.       About           About HiP...
  347.        Exit           Hmm..
  348.  
  349.  Pre    Pop up the prefs window. You can also close it with this button.
  350.  
  351.  Mo    Move the chosen module. [M]
  352.     Removes the module from list allowing you to move around.
  353.     To insert it back press Mo again or Play (or the keys).
  354.  
  355.  In    Insert modules after the selected module. [I]
  356.     This is almost the same as 'Add'.
  357.  
  358.  In + right mousebutton [S]
  359.     Sort list alphabetically. With lot's of files this may be a
  360.     bit slow (bubble sort).
  361.  
  362.  Lp    Load module program. [P]
  363.  
  364.  Sp    Save module program. [W]
  365.  
  366.  The leftmost propgadget
  367.     Scroll module list.
  368.  
  369.  Windowclose-button [ESC]
  370.     Close all windows except requesters and exit.
  371.  
  372.  ** Other keys **
  373.  ARROW UP    Select previous module.
  374.  ARROW DOWN    Select next module.
  375.  SPACE        Toggle play/stop.
  376.  *, (next to RETURN) Randomize and play a module.
  377.  7,8,9        Show: time-pos/len-song number, clock-free mem, module name.
  378.  Z              Toggles selected scope.
  379.  F1-F10        Load & play a module or a module prorgram.
  380.  `~ (next to 1)    Zip window (also shows when hidden).
  381.  
  382.  lamiga-lshift-control + h
  383.         Hides HiP and shows when pressed again.
  384.  
  385. *** Number pad ***
  386. [ ] / *      [ = del, ] = move, / = insert, * = play random
  387. 7 8 9 -      7 = play previous, 8 = select previous, 9 = play next, - = vol down
  388. 4 5 6 +      4 = prev song, 5 = stop/cont, 6 = next song, + = vol up
  389. 1 2 3 E      1 = rewind, 2 = select next, 3 = fast forward, enter = play
  390. 0 0 . E      0 = add files, . = load program, enter = play
  391.  
  392. *** Keyboard note ***
  393. Press lamiga-lshift-control-<key> to use the HiP-keys WITHOUT first
  394. activating the window.  This is one of the two ways (the other is ARexx) to
  395. control HiP when it is hidden!  Pressing zip window this way will bring the
  396. window to front and activate it.
  397.  
  398. *** File requester note ***
  399. HiP uses the great reqtools-requesters.  To select multiple files click
  400. files with shift pressed!  You can also select directories when 'Add'ing or
  401. 'In'serting.
  402.  
  403.  
  404. Filebox
  405. -------
  406. Here you can see the module list.  You can select a module by pressing the
  407. left mousebutton on it or by pressing arrows up and down.  The selection
  408. bar will be kept visible.  If 'Center name' is set, it will be centered.
  409.  
  410.  
  411. Right mousebutton
  412. -----------------
  413. Pressing the right mousebutton or the respective key will shrink the window
  414. so that only the titlebar will be shown.  Press again on the activated
  415. window to expand.
  416. If you somehow lose the window, just load the program again.  If there
  417. already was one HippoPlayer running, it's window will be popped to front
  418. and expanded.  Also pressing lamiga-lshift-control+`~ will pop the window
  419. to front.
  420.  
  421.  
  422.  
  423.  
  424. ******************************************************************************
  425. *                              *** Prefsá****                     *
  426. ******************************************************************************
  427.  
  428. Here you can configure HippoPlayer by using the gadgets & buttons.  You can
  429. invoke a multiple choice requester by pressing right mousebutton on the
  430. following gadgets:
  431.     ╖ Play
  432.     ╖ Show
  433.     ╖ PS3M mode 2
  434.     ╖ Type of scope
  435. The requesters are somewhat different than in most other programs because I
  436. use only reqtools.library.
  437.  
  438.  
  439. Play
  440. ----
  441.  List repeatedly    Play module list over and over.
  442.  List once        Play list once stop.
  443.  Module repeatedly    Play one module over and over.
  444.  Module once        Play one module once and stop.
  445.  Modules in random order
  446.         Play modules in random order.
  447.         When playing has started, same module will not be played twice
  448.                 unless all modules have been played first.
  449.              
  450. 'Play'  affects  the  replayers  where  the end of the song can be detected
  451. from.
  452.  
  453.  
  454.  
  455. Show (titlebar information)
  456. ----
  457.  Time, pos/len, song    Show playing time, song position/length and
  458.             song number/max song (#n/n) depending of what kind
  459.             of a module is being played.
  460.  Clock, free memory     Show clock (24h) and free CHIP and FAST in kilobytes.
  461.  Module name        Show module name.
  462.  
  463.  
  464.  
  465. Filter control
  466. --------------
  467. Filter controlled by module, filter forced off or on.
  468.  
  469.  
  470.  
  471. Module directory
  472. ----------------
  473. Here you can enter your module directory or select it by pressing '?'.
  474.  
  475.  
  476.  
  477. Program directory
  478. -----------------
  479. Same as above but for saving module programs.
  480.  
  481.  
  482.  
  483. Screen
  484. ------
  485. Select a public screen.  All HiP's windows and requesters will then be
  486. opened on the defined screen.  If the screen is not available, default
  487. screen will be used (usually Workbench).
  488.  
  489.  
  490.  
  491. Protracker tempo
  492. ----------------
  493. Enable or disable Protracker tempo command.  Use on old modules that use
  494. speeds higher than $1F.
  495.  
  496.  
  497.  
  498. PT replayer
  499. -----------
  500. Normal:  Use normal Protracker replayer to play modules from CHIP RAM.
  501. Fastram: Play PT modules from FAST RAM.
  502. PS3M:     Use Guru's PS3M to play modules from CHIP or FAST.
  503.      This way you can use those neat modes, eg listen Protracker
  504.      modules with real surround.
  505.  
  506.  
  507.  
  508. Scopes
  509. ------
  510. Select one of the scopes by clicking the type gadget and the bar gadget.
  511. The 'Scope on/off' button or 'z' key will start it up.  You can close a
  512. scope by closing it's window or clicking the gadget again.
  513.  
  514. These are for Protracker-modules only:
  515.  
  516. Quadrascope (& bars)
  517.  - This is just like the one in Protracker.  Channel order:  1,2,3,4.
  518. Hipposcope (& bars)
  519.  - Couldn't invent a better name..  Bass-sounds look nice with this one.
  520.    Channel order: 1,2,3,4.
  521. Frequency analyzer (& bars)
  522.  - This one's more processor intensive.  There is one for the left and the
  523.    right side. It is supposed to display frequencies while not using
  524.    period values. This is not FFT, but is based on Guru's strange idea...
  525.    Bass-sounds are on the left and treble-sounds on the right.
  526.    Bar channel order: 1,4,2,3.
  527. Patternscope
  528.  - Protracker-emulator... Shows pattern data, four fake VU-meters and four
  529.    tiny period boxes.
  530.    Channels: 1,2,3,4.
  531. Bars
  532.  - These will try to visualize the volume and the period of each channel.
  533.    The vertical position represents sample period and the width sample volume.   
  534.  
  535. There  are  almost  the  same  scopes  for PS3M:  Quadrascope (stereoscope,
  536. actually), hipposcope and frequency analyzer.  No bars.
  537.  
  538. The  scopes  will  need some kilobytes of memory for buffers.  They are run
  539. with priority of -30 so that they won't interfere with anything important.
  540.  
  541.  
  542.  
  543. TFMX rate
  544. ---------
  545. Mixing rate for the 7-channel TFMX replayer.
  546.  
  547.  
  548.  
  549. Timeout
  550. -------
  551. Set playing time (mins:secs).  Disabled in the leftmost position.  Timeout
  552. can affect all modules or only those which the end can't be detected from.
  553. You can select this by pressing 'Timeout'.
  554.  
  555. Example:  Play Protracker-modules until they end and PSIDs for, say 3
  556. minutes.  Or you can play all kinds of modules for only 30 secs (intro scan
  557. :).
  558.  
  559.  
  560.  
  561. Filebox size
  562. ------------
  563. Define the number of files showed simultaneously in the main window.
  564. Minimum is 3 and maximum is 50 (will need a BIG screen).  If the value is
  565. too big for the current screen, it will be truncated.
  566.  
  567.  
  568.  
  569.  
  570. Archivers (LhA... LZX... Zip...)
  571. ---------
  572. HiP can decompress and play LhA, LZX and Zip files.  You need to specify a
  573. path, a command and options for each.
  574.  
  575. LhA, LZX and Zip archives will be extracted into a file right after '>'
  576. (for LhA and Zip this is output redirection).  The %s means the name of the
  577. archive to be opened.  The output file can be placed somewhere else than in
  578. RAM:  if you don't have enough memory.
  579.  
  580. You need: LhA, LZX or UnZip, according to what kind of packed files you have
  581.       (be sure they really are where you defined them to be),
  582.       and 'Run' command in C:. LZX also needs 'C:Execute' and 'S:SPAT'.
  583.  
  584. These kind of files are identified by checking the name.  LhA files have
  585. suffix '.lzh' or '.lha', LZX files '.lzx' and zip files '.zip'.
  586.  
  587. ** Hint **
  588. - Archived files may be packed with XPK, FImp or Powerpacker.  For example,
  589. you could use xpkDLTA to encipher a module and then LhA it.  Gives very
  590. good compression of sound related data.
  591.  
  592. ** LhA hint **
  593. - You can store both TFMX mdat.  and smpl.  files in one archive!  Just
  594. remember that the files MUST BE unpacked before archiving and mdat file
  595. MUST BE added into archive first!
  596.  
  597.  
  598. Archiver commands
  599. -----------------
  600.  
  601. LhA -> c:lha >T:virtahepo p -qMNIQw "%s"
  602. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  603. c:lha        the program lha and complete path
  604. >RAM:virtahepo    A file where decompressed data will be stored.
  605.         Can be placed for example on HD (>dh1:temp/rhinocerus)
  606. p        Print files to stdout, in other words in file after the '>'.
  607. -qMNIQw        q    be quiet
  608.         M    no autoshow files
  609.         N    no progress indicator
  610.         I    ignore LHAOPTS variable
  611.         Qw    disable wildcards
  612. "%s"        The %s will be replaced with archive name.
  613.  
  614.  
  615. LZX -> C:execute s:HiP-script "%s" T:HiP-temp c:lzx ;>T:HiP-temp/virtahepo
  616. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  617. This is a tricky one.  Thanks to Gavin Hamill for the illuminating script
  618. (which HiP-script is based on).  'S:HiP-script' will make a temp dir
  619. 'T:HiP-temp' and extract the LZX archive there (c:lzx is the full path &
  620. name for lzx).  Then the file that was extracted is renamed to 'virtahepo'
  621. so that HiP can recognize and load it.  Note that the
  622. ';>T:HiP-temp/virtahepo' statement in the commandline is there just to show
  623. HiP where to look for the file.  Also note that the temp dir is not deleted
  624. afterwards.
  625.  
  626. Change 'c:lzx' to where lzx resides in your system!  Same thing for
  627. 's:HiP-script'.
  628.  
  629. 'S:SPAT' script file is required!
  630.  
  631. If you want the temp dir somewhere else than T:, change all 'T:HiP-temp's
  632. in the commandline.
  633.  
  634. Example to extract LZX archives to HD:
  635. C:execute s:HiP-script "%s" dh1:temp/dung ;>dh1:temp/dung/virtahepo
  636.  
  637.  
  638.  
  639. Zip -> C:unzip >T:virtahepo -cqq "%s"
  640. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  641. -cqq    c    extract files to stdout
  642.     qq    be very quiet
  643.  
  644.     
  645. You can also use other programs for uncompressing.
  646. Example for LhA:    c:lhx >RAM:virtahepo p -qMNQw "%s"
  647.  
  648.  
  649.  
  650.  
  651.  
  652. PS3M settings
  653. -------------
  654. This replayer (by Guru/S2) can play S3Ms, XMs, FTMs, MODs and MTMs.
  655.  
  656. State/buf (System state / buffer size):
  657.     Humble    Allow multitasking when playing. Playing process will use
  658.           priority of -3, in other words it will run with the
  659.           leftover CPU cycles of the system. With big mixing
  660.           buffers plays fine and doesn't jam the system
  661.           (on my 030/28Mhz that is :).
  662.     Friendly  Same as Humble but with priority +3. PS3M will get almost
  663.           total control of the CPU if needed. 
  664.     Killer    Disable system and stop most of the DMA to get the best
  665.                   quality. The blue flickering represents free CPU time.
  666.           Stop playing by pressing mousebuttons.  No enforcer!
  667.     Buffer    4kB, 8kB, 16kB, 32kB, 64kB mixing buffer size.
  668.           Smaller buffer gives faster response, but decreases the
  669.           "backup" buffer possibly causing more "skipping".
  670.  
  671. Play mode:     Playing modes (see the PS3M doc for more info, or just
  672.                 try them out)
  673.  
  674. Volume boost:
  675.     Makes the sound clearer and louder (use when 8 or more channels)
  676.     You will hear the change almost immediately.
  677.  
  678. Mrate (mixing rate):
  679.     Mixing rate in kHz.
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686. Fade volume
  687. -----------
  688. This will cause those replayers that support volume to fade music in and
  689. out.
  690.  
  691.  
  692.  
  693. Hotkeys
  694. -------
  695. Enable/disable lamiga-lshift-control-<key> keys.  This is for preventing
  696. collisions with other programs that may be using the same key combination.
  697.  
  698.  
  699.  
  700. Doubleclick
  701. -----------
  702. When enabled, a module can be loaded and played by doubleclicking on it.
  703.  
  704.  
  705.  
  706. Center name
  707. -----------
  708. When enabled, chosen module will be centered in the filebox.
  709.  
  710.  
  711.  
  712. XPK identify
  713. ------------
  714. When on, all XPKed files will be checked if they should be loaded in FAST
  715. memory.  You should set this if you listen to modules played by PS3M.
  716.  
  717.  
  718.  
  719. Continue on error
  720. -----------------
  721. Errors that occur while loading will be ignored, file will be skipped and
  722. the next one will be loaded.  Beware!  You must have at least ONE module in
  723. the list that can be loaded!  Otherwise HiP may be left stuck in a loop
  724. trying to load modules and always failing.
  725.  
  726.  
  727.  
  728. Doublebuffering
  729. ---------------
  730. Normally when loading a module the one that is playing is ejected.  With
  731. this button you can force HiP to play the current module and load the next
  732. one at the same time.  Useful for floppy users, no delays between playing.
  733. If there's not enough memory to hold two mods at the same time the one that
  734. is played will be ejected before loading.
  735.  
  736.  
  737.  
  738. Nasty audio
  739. -----------
  740. Select allocation priority of the audio channels.  When on, no program
  741. except HiP can use the channels.  PS3M uses maximum priority at all times.
  742.  
  743.  
  744.  
  745. VBlank timer
  746. ------------
  747. Select timing method to be used for playing: VBlank or CIA timer.
  748.  
  749. Use this switch if you don't want HiP to use one of the two CIAA timers.
  750. VBlank plays with wrong speed on non-50Hz screens.
  751.  
  752. This switch has no effect on the following:  PS3M, SID, Sonic Arranger,
  753. TFMX, TFMX 7c, MED, The Player 6.0a.  They use their own way of timing that
  754. may cause serial stops.  Atleast PS3M does that.
  755.  
  756. Tempo will be disabled when playing PT mods with VBlank timer.
  757.  
  758.  
  759.  
  760. Priority
  761. --------
  762. Select a priority for HiP's processes:  -1, 0, +1.  All excluding
  763. HippoScope are affected.
  764.  
  765.  
  766.  
  767. Startup
  768. -------
  769. When enabled, HiP will start playing immediately on startup.  The module or
  770. the program to be played can be chosen by clicking the 'Startup' gadget.
  771.  
  772.  
  773.  
  774. Function keys
  775. -------------
  776. You can install a module or a module program for each of the function keys
  777. (F1-F10) by clicking this gadget.  Then when you press a fkey, the
  778. corresponding module program or module will be loaded and played.
  779.  
  780.  
  781.  
  782. Player group
  783. ------------
  784. Status:     Player group loaded/not loaded.
  785. Mode:        Loading conditions
  786.         - Startup: load immediately on startup
  787.         - Demand: load when there is demand for the players
  788.         - Disable: don't load players and unload if already loaded
  789. File:        Player group file.
  790.  
  791. These can be changed from the gadgets.
  792.  
  793.  
  794.  
  795. Font
  796. ----
  797. Select a 8x8 pixel font (kick2.0+ only).  All fixed width and 8 pixel high
  798. fonts will be scanned and only those that are 8x8 pixel fonts are
  799. displayed.  This thorough scan also LOADS all 8 pixel high fonts in memory.
  800. Afterwards you should type 'avail flush' in Shell or select flushlibs from
  801. WB's Debug menu to free all unnecessary fonts.
  802.  
  803.  
  804.  
  805. Save, Use, Cancel
  806. -----------------
  807. I guess you can guess these.  If you close the prefs window it's same as
  808. 'Cancel'ling.  The prefs-file will be saved in the S:  directory.
  809.  
  810.  
  811.  
  812.  
  813.  
  814. ******************************************************************************
  815. *                        *** Command line options ***                  *
  816. ******************************************************************************
  817.  
  818. Add modules to the list
  819. -----------------------
  820. HiP  <file2> <file2> ... <file16>
  821.  
  822. All the files will be added to the list and the first added one will be
  823. played.
  824.  
  825.  
  826. Load a module program
  827. ---------------------
  828. HiP PRG <module program>
  829.  
  830. The program will be loaded and the first module will be played.  If the
  831. playmode is set as 'Modules in random order', then a random module will be
  832. picked and played.  Existing list will be cleared.  (The PRG-keyword is not
  833. necessary, but is faster in terms of disk activity.)
  834.  
  835. All filenames must be entered with full paths!
  836.  
  837. *** NOTE:  You can also do these things while HiP is ALREADY running!  This
  838. allows you to use HiP as a command line module player.  Eg in Directory
  839. Opus it makes a good play button.
  840.  
  841.  
  842. Hide on startup
  843. ---------------
  844. HiP HIDE [other parameters]
  845.  
  846. HIDE makes HiP even more a command line player.  It will force HiP not open
  847. it's window.  Also reqtools.library is not needed (it will be loaded later
  848. if the window is opened).  HiP can be controlled with hotkeys (if enabled)
  849. and/or ARexx if the window is not opened.
  850.  
  851.  
  852. Quit
  853. ----
  854. HiP QUIT
  855.  
  856. If there is already one HiP running, it will be terminated.
  857.  
  858.  
  859.  
  860. ******************************************************************************
  861. *                              *** ARexx ***                           *
  862. ******************************************************************************
  863.  
  864. HiP has an ARexx port 'HIPPOPLAYER'.  It will be initialized at startup if
  865. RexxMaster is found running.  Works (ofcourse) on Kick1.3 too.  There are
  866. some simple ARexx-examples in the ARexx-dir.
  867. *** Note!  The ARexx-interface and commands are not very thoroughly tested.
  868. If there appears any misbehaviour, tell me please!
  869.  
  870. Parameters in [] may be omitted, parameters in <> may not!
  871.  
  872. CHOOSE <num>        Choose file number <num> in list.
  873. ADD [file]        Add file [file] to list. If not specified, open
  874.             file requester.
  875. DEL            Delete chosen file from list.
  876. CLEAR            Clear list.
  877. MOVE <num>        Move chosen module after file number <num>.
  878. INSERT <file>        Insert file <file> after chosen file.
  879. SORT            Sort file list.
  880. LOADPRG [file]        Load program [file]. If not specified, open
  881.             file requester.
  882.  
  883. PLAY [file]        Clear list and play file [file]. If not specified,
  884.             open file requester.
  885. EJECT            Stop playing and free current module.
  886. STOP            Stop playing.
  887. CONT            Continue playing after stop.
  888. PLAYSONG <num>        Play song number <num>.
  889. RANDPLAY        Pick a random module and play it.
  890. FFWD            Jump forwards in song.
  891. REW            Jump backwards in song.
  892. VOLUME <vol>        Set volume <vol> (0-64).
  893.  
  894. QUIT            Close all windows and exit program.
  895. ZIP <0/1>        0: small main window, 1: normal main window
  896. HIDE <0/1>        0: hide main window, 1: show main window
  897. PUBSCREEN <screen>    Set public screen for HiP's windows & requesters.
  898.             Note that this is case sensitive.
  899.  
  900. TIMEOUT <secs>        Set timeout (0-600 secs).
  901. PS3MBOOST <value>    Set PS3M volume boost (0-8).
  902. PS3MMODE <mode>        Set PS3M mode. 1: surround, 2: stereo, 3: mono,
  903.             4: real surround, 5: 14-bit stereo.
  904. PS3MRATE <rate>        Set PS3M mixing rate (5000-56000).
  905.  
  906. LOADPREFS <file>    Load prefs file. Restart HiP with the new settings.
  907.             HiP only saves prefs to S:HippoPlayer.prefs, so
  908.             you have to collect them manually somewhere for
  909.             ARexx-usage.
  910.  
  911. GET <xxxx>    With this command you can get different information from HiP.
  912.         The <xxxx> can be one of the following:
  913.         xxxx:    result:
  914.         PLAY    0 if not playing, 1 if playing.
  915.         CFIL    Number of chosen file, 0 if none chosen.
  916.         NFIL    Number of files in list.
  917.         CURR    Number of loaded module.
  918.         NAME    Module name.
  919.         TYPE    Module type.
  920.         CNAM    Name of chosen file.
  921.         CSNG    Current song number.
  922.         NSNG    Number of songs available.
  923.         CSPO    Current song position.
  924.         MSPO    Maximum song position.
  925.         FNAM    Full name of loaded file.
  926.         COMM    Comment for loaded file.
  927.         SIZE    Size of loaded file.
  928.             
  929.  
  930.         
  931.  
  932. ******************************************************************************
  933. *                                *** Bugs ***                           *
  934. ******************************************************************************
  935.  
  936. 1.    Main window refresh gets perhaps even dangerously confused 
  937.     when zipping window via zoomgadget while loading module/program,
  938.     saving program or sorting. One zip is allowed, two is too much,
  939.     so be careful.
  940.     
  941.  
  942. ******************************************************************************
  943. *                              *** History ***                           *
  944. ******************************************************************************
  945.  
  946. Read this!  Some things are not mentioned elsewhere!
  947.  
  948.  
  949. v1.00    Works...
  950.     I couldn't check the bug I suspected because a friend of
  951.         mine wanted to upload the program everywhere. This bug causes
  952.     memory to get fragmented when loading XPK files.
  953.  
  954. v1.01    No major bugs left..
  955.  
  956. v1.10   ╖ Removed some small bugs here and there.
  957.     ╖ A description of the gadgets in the program.
  958.     ╖ Support for multisong Protracker modules.
  959.         ╖ Replayer which plays S3M/FTM/MOD/MTM modules, by Guru (jee).
  960.     ╖ Load/save module program.
  961.     ╖ Commandline options.
  962.     ╖ Four scopes.
  963.     ╖ Communication between most of HiP's processes. All windows except
  964.           reqtools requesters will be closed when the main window is closed.
  965.     ╖ Window positions will be saved in the prefs-file. Also the state
  966.       of the scope (on/off) will be saved.
  967.     ╖ Doesn't interfere with serial transfers on slower Amigas anymore.
  968.           Exceptions are MED, TFMX, The Player.
  969.           They use their own way of timing (level 6 here I come).
  970.         ╖ Works correctly on both PAL and NTSC.
  971.     ╖ Behaves more intelligently with bigger fonts, eh...
  972.     ╖ If playingmode is 'Random', Next/Prev will randomize a new
  973.       module instead of what they would normally do.
  974.     ╖ Removed a bug in ProTracker's arpeggio.
  975.     ╖ Newlook propgadgets on Kickstarts 2.0+.
  976.     ╖ FutureComposer end-detect.
  977.  
  978. v1.11    ╖ Now should work on 50/60/72Hz screens correctly.
  979.     ╖ New icon (less eyesore?).
  980.     ╖ Filter control in Prefs.
  981.     ╖ Doesn't try to open windows over screen's borders.
  982.     ╖ Info window, in which an option to show samplenames.
  983.     ╖ TFMX channel autodetect.
  984.     ╖ New PS3M -> Mixingrate: 5-56 kHz, volumeboost: 0-8
  985.     ╖ Lotsa fixes'n stuff.
  986.  
  987. v1.12 (19.7.1994)
  988. -----------------
  989.     ╖ Fixes'n stuff part 2.
  990.     ╖ New scope: Frequency analyzer
  991.     ╖ More stuff in info window.
  992.     ╖ New formats: The Holy Noise, MED 5-8 channels.
  993.     ╖ Executable size (and memory usage) reduced.
  994.       Achieved this by packing nearly all the replayers.
  995.     ╖ Removed a bug that caused PT vibratos to disappear. This bug
  996.       was created when I removed the arpeggio-bug. Hmm..
  997.     ╖ More informative loading phase.
  998.     ╖ Enables/disables gadgets according to current replayer.
  999.     ╖ New prefs design.
  1000.     ╖ Modulebox can now contain 8 names.
  1001.     ╖ Titlebar information printed with SetWindowTitles().
  1002.     ╖ PT modules can be played from FAST RAM.
  1003.     ╖ End-detect: JamCracker, Oktalyzer, SoundMon v2.0.
  1004.  
  1005. v1.14 (30.7.1994)
  1006. -----------------
  1007.     ╖ Fixed a bug in 'del' (caused a crash sometimes).
  1008.     ╖ Almost full keyboard control.
  1009.     ╖ New formats: Delta Music v2.0, Sonic Arranger.
  1010.     ╖ Some enchancements in the filebox and in the slider.
  1011.     ╖ PS3M now frees ALL buffers needed for playing.
  1012.     ╖ LhA, Zip & Gzip compatibility.
  1013.     ╖ Added a clock (titlebar info).
  1014.  
  1015. v1.15 (5.8.1994)
  1016. ----------------
  1017.     ╖ A couple of fixes here and there.
  1018.     ╖ Next/prev working fine again.
  1019.     ╖ Added a key for random play.
  1020.  
  1021. v1.16 (12.8.1994)
  1022. -----------------
  1023.     ╖ LhA/Zip/Gzip filehandling much better.
  1024.     ╖ A bug in samplenamesroutine fixed.
  1025.     ╖ PS3M priority reduced from 2 to 0.  
  1026.     ╖ PS3M system friendly mode end-detect (S3M, FTM, MOD, MTM).
  1027.     ╖ Show free memory in titlebar.
  1028.     ╖ SoundMon v2.0 bug fixed.
  1029.     ╖ Stringgadgets' fontbug corrected (hopefully).
  1030.     ╖ Volumeboost controlled with propgadget.
  1031.     ╖ Scope priority from -5 to -30.
  1032.     ╖ Priority selector in prefs (for mainprogram).
  1033.     ╖ Startup errormessages.
  1034.     ╖ Memory usage reduced 5kB compared to v1.15
  1035.  
  1036. v1.17 (?.8.1994)
  1037. ----------------
  1038.     ╖ Some fixes.
  1039.     ╖ Numerous bugs seemed to appear in v1.16. Hunt in progress..
  1040.       Removed one in TFMX 7ch interface.
  1041.       SoundMon v2.0 bug removed (again, was not fixed in v1.16).
  1042.  
  1043. v1.18 (22.8.1994)
  1044. -----------------
  1045.     ╖ Bughunt continues.
  1046.       Several removed and among them one that possibly scrambled memory.
  1047.     ╖ Non-existent doublebuffering changed to fade volume.
  1048.  
  1049. v1.19 (?.?.1994)
  1050. ----------------
  1051.     ╖ No volume fading when tune ends while using randomplay.
  1052.     ╖ PS3M priority changed again, this time to +1.
  1053.     ╖ Windowcoloring.
  1054.     ╖ PT replayer still had bugs left: vibrato & tremolo were too
  1055.       strong! Fixed.
  1056.     ╖ No more H.P.Lovecraft.
  1057.  
  1058. v1.20 (2.9.1994)
  1059. ----------------
  1060.     ╖ LhA/Zip/Gzip enchanced and some bugs removed.
  1061.     ╖ New backround color looked wrong on 8+ color screens. Fixd.
  1062.     
  1063. v1.23 (?.9.1994)
  1064. ----------------
  1065.     ╖ SID support! Now you can listen all those cool C64 tunes!
  1066.     ╖ Samplenames => Moduleinfo. Now also info about SID modules.
  1067.     ╖ Open moduleinfo window also by pressing left mousebutton on the
  1068.       name/type box or pressing 'I'.
  1069.  
  1070. v1.25 (13.9.1994)
  1071. -----------------
  1072.     ╖ Major changes in LhA/Zip/Gzip interface. Should work OK, finally.
  1073.       The version in v1.15 onwards really acted strange!
  1074.     ╖ Stereoscope for PS3M, might not work very well though.
  1075.  
  1076. v1.28 (21.10.1994)
  1077. ------------------
  1078.     ╖ The timer will wrap properly now.
  1079.     ╖ All replayers excluding PT and PS3M didn't work on 68040 because
  1080.       of the copyback-cache. Should work OK now.
  1081.     ╖ Timer and pos/len are now shown at the same time.
  1082.     ╖ Moduleinfo reorganized. All PT samplenames in same window.
  1083.  
  1084. v1.30 (7.11.1994)
  1085. -----------------
  1086.     ╖ Fixed a very silly bug (changed the volume depending on the size
  1087.       of the module being played!).
  1088.     ╖ New scope: SID.
  1089.     ╖ Improved Shell interface. Allows HiP to be more a commandline
  1090.       moduleplayer.
  1091.     ╖ Time, pos/len and song number shown at the same time.
  1092.     ╖ The timer uses DateStamp().
  1093.     ╖ Requesters use the same font as the mainprogram.
  1094.     ╖ Some gfx bugs fixed.
  1095.     ╖ NEW VERSION OF THE PS3M! Mixingroutines for 68000 and 68020++. 
  1096.       Faster and more beautiful! Stop/cont/fastforward/rewind etc.
  1097.     ╖ Two more scopes for PS3M.
  1098.     ╖ Removed The Holy Noise.
  1099.     ╖ The Player version increased to v6.1A.
  1100.     ╖ When a module jumps backwards it is considered ended. Works with
  1101.           PS3M and ProTracker.
  1102.  
  1103. v1.31 (12.11.1994)
  1104. ------------------
  1105.     ╖ Several not so serious bugs fixed.
  1106.     ╖ After playing TFMX 7c tunes, programs using lev4 interrupt crashed
  1107.       (like PS3M). Fixed.
  1108.     ╖ Some Prefs-window reorganization.
  1109.     ╖ Hippoicon by Tommi Lindstr÷m (Hawk/Hippopotamus Design).
  1110.         
  1111. v1.32 (18.11.1994)
  1112. ------------------
  1113.     ╖ Pressing "Play" on the module currently being played caused
  1114.        HiP to load next module (in list-playmodes).
  1115.     ╖ Module program directory saved in the prefsfile.
  1116.     ╖ Samplenameviewer works OK, no more garbage.
  1117.     ╖ Some PS3M bugs removed (stop-eject=no guru).
  1118.     ╖ ProTracker replayer can cope with a bit mutated modules too.
  1119.  
  1120. v1.33 (7.12.-94)
  1121. ----------------
  1122.     ╖ Unofficial release...
  1123.  
  1124. v1.34 (11.12.-94)
  1125. -----------------
  1126.     ╖ Numerous fixes here and there.
  1127.     ╖ BPSoundMon enchancements: position/length, ffwd and rew, volume.
  1128.     ╖ More info in the infowindow.
  1129.     ╖ Number of subsongs checked: TFMX, TFMX 7c, Fred.
  1130.     ╖ When there's no "moduleinfo" available and the left mousebutton is
  1131.       pressed on the left third of the textbox, infowindow will be opened.
  1132.     ╖ TFMX & TFMX 7c enchancements: position/length, ffwd and rew,
  1133.           songend.
  1134.     ╖ Sometimes PS3M didn't start to play in killermode (my fault). Fixed.
  1135.     ╖ New design in the main window.
  1136.     ╖ Amount of files showed in the main window now selectable.
  1137.     ╖ Amount of songs (if available) shown after current songnumber.
  1138.     ╖ Some samplenameviewer bugs removed.
  1139.     ╖ IMPORTANT: Versions 1.30 to 1.33 didn't work on A500 or A600,
  1140.       in other words on 68000. This version should work OK.
  1141.  
  1142. v1.35 (2.1.-95)
  1143. ---------------
  1144.     ╖ Samplenameviewer still had a bug! Vanquished it!
  1145.     ╖ New scope for ProTracker: patternscope.
  1146.     ╖ Prefs: doubleclick, center name, some gfx changes,
  1147.              multiple choice requesters with RMB.
  1148.     ╖ Stringgadgets in prefs will only accept fonts of size 8 or
  1149.       smaller. No more trash.
  1150.      ╖ Aargh! Stupid LhA command mistake corrected! %s" -> "%s" !
  1151.     ╖ ProTracker replayer caused Enforcer hits! Fixed...
  1152.     ╖ Module name shown in the title of the samplenamewindow.
  1153.     ╖ Removed that little window when opening LhA, zip and gzip files.
  1154.     ╖ ProTracker: Songnumber not shown and NS/PS gadgets disabled
  1155.       when there's only one song in module (most modules have only
  1156.       one song).
  1157.     ╖ Removed the SID scope. It was "illegal" as it used some
  1158.           undocumented functions in the playsid.library. 
  1159.     ╖ Removed the PT fastram player. It was terrible.
  1160.     ╖ TWO SERIOUS BUGS REMOVED! When playing ProTracker modules
  1161.           (or alike), my PT replayer and Guru's PS3M sometimes
  1162.       scrambled system's memorylist! Aargh (part 2)!!
  1163.     ╖ Found more bugs in the PT replayer. I have been using it for
  1164.       two years and there's still bugs left... Some effect commands
  1165.           weren't played correctly while notedelaying (EEx). Fxd.
  1166.     ╖ Player v6.1A: Stop/cont working again. 
  1167.  
  1168. v1.38 (9.1.1995)
  1169. ----------------
  1170.     ╖ Oktalyzer modules played wrong on non-50Hz screens. Fixed.
  1171.     ╖ One TFMX 7c interface bug removed.
  1172.     ╖ Added startup play.
  1173.     ╖ Added load & play module or program by pressing the function
  1174.       keys.
  1175.     ╖ No need to have PRG in front of the filename anymore when loading
  1176.       programs via commandline.
  1177.     ╖ Programs can be loaded with New/Play.
  1178.     ╖ File & directoryrequesters use the font defined in system's prefs.
  1179.     ╖ Fixed one bug in PS3M (divide by zero-exception when playing S3Ms).
  1180.  
  1181. v1.39 (12.1.1995)
  1182. -----------------
  1183.     ╖ Quick bug fix! Damn I'm stupid! v1.38 doesn't work on 68000,
  1184.       this version does.
  1185.     ╖ The main window is now an AppWindow! Now you can drop modules and
  1186.       module programs on the window and they get loaded and played.
  1187.       This feature is for kick2.0+ only.
  1188.  
  1189. v1.40 (21.1.1995)
  1190. -----------------
  1191.     ╖ The terrible fastramplayer is back. Works somehow.
  1192.     ╖ Prefs: Show module name in titlebar, set playing time (timeout).
  1193.     ╖ Works better with arc-handler (ARC:).
  1194.     ╖ Killed a killer bug in the PT replayer.
  1195.     ╖ LhA enchancement: Load both TFMX mdat and smpl files from one
  1196.       archive.
  1197.  
  1198. v2.00 (19.3.1995)
  1199. -----------------
  1200.     * ARexx support
  1201.     * Public screen support
  1202.     * Keyboard control changes: you can use the keys without activating
  1203.       the window first by pressing lamiga-lshift-control-<key>.    
  1204.     * New PS3M: support for Fasttracker 2 (XM) modules.
  1205.     * Improved outlook.
  1206.     * Patched playsid.library so that it's possible to play SID-tunes
  1207.       also on kick1.2/1.3.
  1208.     * Prefs: continue on error, hotkeys, nasty audio, doublebuffering,
  1209.              program dir selector.
  1210.     * Main window: move, insert, sort (hidden under insert)
  1211.     + Timeout has now two modes.
  1212.     + You can 'Add', 'New' and 'In' directories.
  1213.     + New The Player v6.1a replayer.
  1214.     + PT replayer causes no serialstops.
  1215.     + Command line: HIDE, QUIT.
  1216.     + Prefs: PS3M volume boost has immediate effect on music.
  1217.     + Included some support progs.
  1218.     ╖ PSID-files are loaded in public mem if possible.
  1219.     ╖ HiP can be hidden with lamiga-lshift-control+h.
  1220.     ╖ Key for toggling current scope.
  1221.     ╖ Uses less CPU than v1.40 when not playing.
  1222.     ╖ Filebox routines optimized & jump scroll with shifts.
  1223.     ╖ New algorithmic random generator (thanks Thomas!).
  1224.     ╖ If PT replayer is set as 'Fastram', modules smaller than
  1225.       the replayer's chip buffers (256kB) will be loaded in chipram.. :)
  1226.     ╖ Recognizes .Lha .lHa .lHA like suffixes too.
  1227.     ╖ Only 8 channel Oktalyzer-tunes are loaded in fast ram.
  1228.     ╖ Faster gadget disabling/enabling (OffGadget() was sloooow).
  1229.     ╖ Fixed and enforcer hit when toggling prefs window.
  1230.     ╖ Bug fix in the doc: the player table had some wrong info.
  1231.     ╖ General good stuff and nice things.
  1232.         
  1233. v2.05 (3.5.1995)
  1234. ----------------
  1235.     * Some fixes and improvements here and there.
  1236.     * Keyboard: K/L swapped back with ARROW LEFT/ARROW RIGHT.
  1237.             Added lot's of functions to number pad.
  1238.     * MED: multisong support, song position/song length, forward,
  1239.            rewind, songend. Also no lib-error bug removed.
  1240.     * New PT FAST RAM replayer which uses only 1024 bytes of CHIP RAM.
  1241.     * Replaced GZip support with LZX.
  1242.     * New music formats: Mark II, Maniacs of Noise, David Whittaker,
  1243.                  BP SoundMon v3.0 (v2.2?).
  1244.     * Prefs: VBlank timing selector, switch for scope bars.
  1245.     - Added zoom-gadget (kick2.0+).
  1246.     - Directories are added recursively (kick2.0+).
  1247.     - Fix: PS3M with killer mode caused crashes (my fault).
  1248.     + Added Humble mode for PS3M: priority = -3.
  1249.     + PS3M mixing buffer size can be as high as 64kB.
  1250.     - Fix: randomgenerator bugged heavily (jammed the machine).
  1251.     - Fix: PT replayer patterndelay + volslide.
  1252.     - Double buffering: if not enough memory, dump current module and
  1253.       try again.
  1254.     - When adding modules via AppWindow or commandline they are
  1255.       added to the end of the list, instead of first clearing the list
  1256.       and then adding.
  1257.     - Filter status saved in prefs file. Wasn't saved in prev. versions!
  1258.     - File selection bar is always kept visible.
  1259.     - Better init error handling.
  1260.     - The sort routine is six times faster than before.
  1261.     - Priority affects all processes excluding HippoScope.
  1262.     - Windows adapt with different border sizes (works with sysihack).
  1263.     - Titlebar info: clock and free mem shown at the same time.
  1264.     - Keys works from prefs window too.
  1265.     - A new icon by Cyclone.
  1266.  
  1267. v2.06 (19.5.1995)
  1268. -----------------
  1269.     - This version wasn't actually released.
  1270.     * External player group.
  1271.     + Selectable 8x8 pixel font (kick2.0+).
  1272.     + Title of the sample name window now contains name, comment and size.
  1273.     + Timing is done with CIAA timer. Serialstops should finally
  1274.       be gone now..
  1275.     - Hide had a big bug! Terminated it. (Hi Yolk! (I'm an idiot))
  1276.     - Fixed a bug in HiP-script (LZX extraction).
  1277.     - Pressing 'Use' in prefs window will also change the scope.
  1278.     - Fade volume on exit.
  1279.     - A new icon by Roman Patzner.
  1280.     - Fixed a bug in ZIP (ARexx).
  1281.     - Some PS3M bugs removed.
  1282.     - Some fixes...
  1283.  
  1284.  
  1285.  
  1286.  
  1287. ******************************************************************************
  1288. *                               *** Hellos ***                            *
  1289. ******************************************************************************
  1290.  
  1291. Jarno Paananen (Guru/Sahara Surfers)
  1292. - Hi my friend! Thanks very much for the PS3M and everything else!
  1293.  
  1294. Nico Franτois
  1295.  - Thanks for the great reqtools.library!
  1296.  
  1297. Ron Birk & Per Hσkan Sundell
  1298. - Thanks for making almost perfect SID-emulation.
  1299.  
  1300. Thanks to those who drew the icons:
  1301.  Tommi Lindstr÷m  - The original 4-color face portrait.
  1302.  Richard Harris      - The MWB icon with a hippo lurking.
  1303.  cYClone/nEW-dEAL^PSD PC - The colorful MWB icon.
  1304.  Roman Patzner      - The smaller & nicer 4-color face portrait.
  1305.  
  1306. Henryk Richter (Buggs/Defect)
  1307. - Thanks for the SoundMon v3.0 replayer.
  1308.  
  1309. Special hellos:
  1310. ---------------
  1311. Agust Arni Jonsson (Nemesis1), Paul Petershagen, Thomas Schuerger, Gavin
  1312. Hamill, Morten Wilken Rasmussen, Aki Laukkanen
  1313.  
  1314. Hellos:
  1315. -------
  1316. Peter Kunath, Fredrik Andersson, Arto Ikola, Kari JΣrvi÷, Zdenek Kabelac,
  1317. Bert Dorhout, Gunther Nikl, Ville Ranki, Andy Church, Peter Reunanen,
  1318. Stelios, Mikko Karvonen, Markus Stenberg, Steve Nordquist, Fred Brooker
  1319.  
  1320.  
  1321. Thanks to all the ones who have sent me registrations, bug reports &
  1322. suggestions!
  1323.  
  1324.  
  1325.  
  1326. ******************************************************************************
  1327. *                               *** About ***                           *
  1328. ******************************************************************************
  1329.  
  1330. The program was made by using Asm-Ones v1.06/1.09/1.25.  Pure assembler
  1331. 100%+++.  Sourcecode length without any includes or play routines = 290kB.
  1332.  
  1333. Registrations, bug reports, comments & suggestions, module swapping and
  1334. C-64 wares are welcome!
  1335.  
  1336.  Kari-Pekka Koljonen
  1337.  Torikatu 31
  1338.  40900 SΣynΣtsalo
  1339.  Finland
  1340.  
  1341.  E-mail: kpkoljon@kauhajoki.fi
  1342.      kpkoljon@freenet.hut.fi (redirected)
  1343.  
  1344.  IRC:     K-P
  1345.  
  1346.  Finns phone: 941-3742699
  1347.